home *** CD-ROM | disk | FTP | other *** search
/ Software Vault: The Gold Collection / Software Vault - The Gold Collection (American Databankers) (1993).ISO / cdr35 / vfx003wb.zip / VOTEFIX.DOC < prev    next >
Text File  |  1993-04-17  |  8KB  |  206 lines
  1. ─ VoteFix v0.04ß ───────────────────────────── Copyright Steve Mulligan 1993 ─
  2.  
  3. |Lines that start with a | have been added/changed from v0.03ß
  4.  
  5. |I could not write these docs without saying thanks to the gang in TEST305.
  6. |Bill, Brian, Paul, Elaine, Shayne, Malcolm, Marc, Steve, Rick - Thanks a
  7. |million!  I coulnd't have released this without your help.
  8.  
  9. NOTE:  This program is FREE to use.  There is NO price to this.  I don't
  10.        believe in charging for software.  If you plan to use this program
  11.        you SHOULD register with me by sending me NetMail telling my
  12. |      how/why you're using VoteFix.
  13.  
  14. WARNING:  This is a Beta Version.  It has tallied small elections on my
  15.       computer and my beta testers systems but yours may be diffrent
  16.       or you may not understand how to configure VoteFix right.  (Just
  17.       NetMail me if you're not sure)  It might not be too smart to
  18.       hold a major election for your local NC or RC.  It will only
  19.       handle about 512 candidates.  It will however allow for up to
  20.       2147483647 votes for each candiate.
  21.  
  22. ─ Introduction ─
  23.  
  24.   VoteFix is a program for holding elections via FidoNet style technology.
  25. Elections can be held on nodes or points and users can send mail to VoteFix
  26. to vote in these elections.  VoteFix will manage the election, print reports
  27. as to who has voted so far and tally the results at the end of the election
  28. for you.
  29.  
  30. ─ The Files ─
  31.  
  32.   These files come with VoteFix:
  33.  
  34.   VOTEFIX.EXE   Executable.
  35.   VOTEFIX.OVR   Overlay File.
  36.   VOTEFIX.DOC   This documentaion.
  37.   VOTEFIX.CFG   The configuration.
  38.   VOTEFIX.USE   Short description of VoteFix.  Like AREAFIX.USE.
  39.   VOTEFIX.INF   Sample election information.
  40.   VOTEFIX.VOT   Sample valid vote list.
  41.   VOTEFIX.DEF   List of all DEF numbers.  Controls what VoteFix looks like.
  42. | VOTEFIX.LST   Sample registered voters list.
  43.  
  44.   Either you or VoteFix will make these:
  45.   
  46.   *.DEF         Definition files to change the way VoteFix appears.
  47.         If these are not found, VoteFix will create a set of
  48.         default DEF files.
  49.  
  50.   *.INF         Information about elections.  This is sent to people when
  51.         they request information about an election.  You should
  52.         also post it somewhere before the election so people know
  53.         what is happening.
  54.  
  55.   *.VOT         Valid vote list.  Every line contains a valid candidate in
  56.         the election.  If a file with this extension exists for an
  57.         election that you have defined, every ballot cast will be
  58.         compared against the candidates in this file.  This is good
  59.         to avoid spelling errors.
  60.  
  61. | *.LST         Registered voters list.  If a file with this extension exists
  62. |               for an election that you have defined, only people listed in
  63. |               this file will be able to vote.  The format of this file is
  64. |               simple.  Each line contains one entry.  The line looks like
  65. |               this :     <address> <username>
  66. |               
  67. |               eg: 1:163/307.30 Steve Mulligan
  68.  
  69. ─ Quick Setup ─
  70.  
  71.   Edit the VOTEFIX.CFG file.  Change the following options to your liking:
  72.  
  73.   Address
  74.   SystemName
  75.   SysopName
  76.   MsgBase
  77.   Subject
  78.   Tally
  79.  
  80. | Optionally, make your INF, VOT and LST files.  Then, make sure VoteFix gets
  81.   executed :
  82.  
  83.   a) Once a day if you scan the whole message base * RECOMENDED
  84.   b) Everytime you get mail if you scan from the lastread message
  85.   
  86. ─ Full Configuration ─
  87.  
  88.   Read the config file for full configuration information.  This section will
  89. be added in the final release.
  90.  
  91. ─ Usage ─
  92.  
  93.   Once you have configured all the needed files, you should install VoteFix
  94. somehow so it gets run :
  95.  
  96.   a) Once a day if you scan the whole message base * RECOMENDED
  97.   b) Everytime you get mail if you scan from the lastread message
  98.  
  99.   The -C command line options specifies the config file to use.
  100.   
  101.   eg: VOTEFIX -CMYFIX.CFG
  102.  
  103.       Will tell VoteFix to use the MYFIX.CFG file as the config file.
  104.  
  105.  
  106.   The -R command line will build a report of the results so far in every
  107.   election (or only the one specified after the -R), consisting only of users
  108.   passwords who have been received and post the report to the message bases
  109.   pointed to in the Tally config verb.
  110.  
  111.   eg: VOTEFIX -R
  112.  
  113.   Will build a report of all elections and post them to the bases pointed to
  114.   by the Tally config verb.
  115.  
  116.       VOTEFIX -RSOFTDRINK
  117.  
  118.   Will build a report of ONLY the SOFTDRINK election and post it to the bases
  119.   pointed to by the Tally config verb.
  120.  
  121.  
  122.   The -T command line will tally the results so far in every election (or only
  123.   the one specified after the -T) and post the report to the message bases
  124.   pointed to in the Tally config verb.
  125.  
  126.   eg: VOTEFIX -T
  127.   
  128.   Will tally results of all elections and post them to the bases pointed to
  129.   by the Tally config verb.
  130.  
  131.       VOTEFIX -TSOFTDRINK
  132.  
  133.   Will tally results of ONLY the SOFTDRINK election and post it to the bases
  134.   pointed to by the Tally config verb.
  135.  
  136.  
  137. | The -B command line loads the built in valid voters list builder.  It's a
  138. | very crude implementation.  It's not very good but it works okay.  If you
  139. | want to make a better one, please do.  The valid voters list builder first
  140. | asks you what election you want to build a valid voters list for.  It then
  141. | allows you to manually register voters or register voters by pulling them
  142. | right from the nodelist using wildcars.
  143.  
  144. ─ Holding An Election ─
  145.  
  146.   To hold an election, you should first setup VOTEFIX.CFG to recognize
  147. messages about that election.  Do this with the Subject verb.
  148.  
  149.   Then, you should make a .INF file with the same filename you used when you
  150. defined your election with the Subject verb.  To get an example of an .INF
  151. file, see VOTEFIX.INF (distributed with VoteFix).
  152.  
  153.   Then, you should make a .VOT file with the same filename you used when you
  154. defined your election with the Subject verb.  This file is a plain text file
  155. that has only the valid votes for the election.  It looks something like this
  156. (SOFTDRNK.INF) :
  157.  
  158. COKE
  159. PEPSI
  160. 7UP
  161. SPRITE
  162. ABSTAIN
  163.  
  164. | Once that is finished, you should make a .LST file with the same filename
  165. |you used when you defined your election with the Subject verb.  The file is
  166. |a plain text file containing the addresses of people allow to vote in the
  167. |election.  NOTE: Only make this file if you want to limit the people who
  168. |participate in your election.  A sample file looks like this:
  169.  
  170. |1:163/307.30 Steve Mulligan
  171. |1:163/307.4 Shayne Macaulay
  172. |1:163/307 Malcolm Campbell
  173.  
  174. ─ Beta Testers Wanted ─
  175.  
  176.   If you are in the 163 or 243 net or you don't mind polling long distance
  177. you are eligible to be a beta tester.  Simply NetMail Steve Mulligan at
  178. 1:163/307.30.  I will reply to you and tell you how to get the latest beta
  179. versions of software I make.
  180.  
  181. ─ On the Drawing Board ─
  182.  
  183.   This is a list of all the features my beta testers and I want to have added
  184. to VoteFix.  I'll get around to it in a while.  PLEASE ADD TO LIST AND FORWARD
  185. TO STEVE MULLIGAN 1:163/307.30.  If you want to become a Beta Tester, NetMail
  186. me and I'll send you beta releases.
  187.  
  188. NOTE : Anything you suggest at the moment WILL BE ADDED IMMEDIATLY.
  189.  
  190. |v1.00  · Unlimited number of candidates to tally by using disk file
  191. |         to store information.
  192.  
  193. |       · Any bug fixes that are reported.
  194.  
  195. v1.10   · Report config verb.  Works much like Tally only used when your
  196.       do a -R command line.
  197.  
  198.     · Allow to change appearance of Large Tally Report and Password
  199.       report.
  200.  
  201. v1.20   · Add optional SoundEX comparisons.
  202.  
  203. If you have any additions to this list or any bugs, please let me know!
  204.  
  205. Steve Mulligan 1:163/307.30@fidonet.org
  206.